ИМЯ¶

readv, writev, preadv, pwritev - чтение или запись данных в несколько буферов

ОБЗОР¶

#include <sys/uio.h>

ssize_t readv(int fd, const struct iovec *iov, int iovcnt);

ssize_t writev(int fd, const struct iovec *iov, int iovcnt);

ssize_t preadv(int fd, const struct iovec *iov, int iovcnt,
               off_t offset);

ssize_t pwritev(int fd, const struct iovec *iov, int iovcnt,
                off_t offset);

Требования макроса тестирования свойств для glibc (см. feature_test_macros(7)):

preadv(), pwritev(): _BSD_SOURCE

ОПИСАНИЕ¶

Системный вызов readv() считывает iovcnt буферов из файла, связанного с файловым дескриптором fd, в буферы, описываемые iov («разнесённый ввод»).

Системный вызов writev() записывает iovcnt буферов, описанных iov, в файл, связанный с файловым дескриптором fd («сборный вывод»).

Указатель iov указывает на массив структур iovec (определён в <sys/uio.h>:

struct iovec {


    void  *iov_base;    /* начальный адрес */


    size_t iov_len;     /* количество передаваемых байт */
};

Системный вызов readv() работает также как read(2), но считывает несколько буферов.

Системный вызов writev() работает также как write(2), но записывает несколько буферов.

Буферы выбираются в порядке, в каком они указаны в массиве. Это означает, что readv() сначала полностью заполнит iov[0], и только потом перейдёт к iov[1], и так далее. (Если данных недостаточно, то могут быть заполнены не все буферы, на которые указывает iov.) Подобным образом writev() запишет сначала всё содержимое iov[0], затем iov[1], и так далее.

Выполняемые вызовами readv() и writev() пересылки данных атомарны: данные записываются writev() единичным блоком, который не перемешивается с выводом других процессов (см. исключения в pipe(7)); аналогично, readv() гарантированно считывает непрерывный блок данных из файла, независимо от операций чтения из других нитей или процессов, которые имеют файловые дескрипторы, ссылающиеся на это же открытое файловое описание (см. open(2)).

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ¶

При успешном выполнении readv() и preadv() возвращается количество считанных байт; вызовы writev() и pwritev() возвращают количество записанных байт. При ошибке возвращается -1, а значение errno устанавливается соответствующим образом.

ОШИБКИ¶

Вызовы могут возвращать те же ошибки что и read(2) и write(2). Кроме этого, preadv() и pwritev() также могут завершаться с ошибками как lseek(2). Дополнительно, определены следующие ошибки:

EINVAL

Сумма значений iov_len превышает значение ssize_t. Или количество векторов iovcnt меньше нуля или больше разрешённого максимума.

ВЕРСИИ¶

Вызовы preadv() и pwritev() впервые появились в Linux 2.6.30; поддержка в библиотеке добавлена в glibc 2.10.

СООТВЕТСТВИЕ СТАНДАРТАМ¶

readv(), writev(): 4.4BSD (впервые появились в 4.2BSD), POSIX.1-2001. В Linux libc5 в качестве типа аргумента iovcnt используется size_t, и int в качестве возвращаемого типа.

preadv(), pwritev(): нет в стандарте, но есть в современных BSD.

ЗАМЕЧАНИЯ¶

ДЕФЕКТЫ¶

Неразумно смешивать вызовы readv() или writev(), работающих с дескрипторами файлов, вместе с функциями из библиотеки stdio; результат непредсказуем и точно не тот, которого вы ожидаете.

ПРИМЕР¶

Следующий пример кода демонстрирует использование writev():

char *str0 = "hello ";
char *str1 = "world\n";
struct iovec iov[2];
ssize_t nwritten;
iov[0].iov_base = str0;
iov[0].iov_len = strlen(str0);
iov[1].iov_base = str1;
iov[1].iov_len = strlen(str1);
nwritten = writev(STDOUT_FILENO, iov, 2);

СМОТРИТЕ ТАКЖЕ¶

pread(2), read(2), write(2)